package com.kuang.exam.modules.paper.service;

import com.baomidou.mybatisplus.core.metadata.IPage;
import com.baomidou.mybatisplus.extension.service.IService;
import com.kuang.exam.core.api.dto.PagingReqDTO;
import com.kuang.exam.modules.paper.dto.export.PaperExportDTO;
import com.kuang.exam.modules.paper.dto.ext.PaperQuDetailDTO;
import com.kuang.exam.modules.paper.dto.request.PaperAnswerDTO;
import com.kuang.exam.modules.paper.dto.request.PaperListReqDTO;
import com.kuang.exam.modules.paper.dto.response.ExamDetailRespDTO;
import com.kuang.exam.modules.paper.dto.response.ExamResultRespDTO;
import com.kuang.exam.modules.paper.dto.response.PaperListRespDTO;
import com.kuang.exam.modules.paper.entity.Paper;

import java.util.List;

/**
 * <p>
 * 试卷业务类
 * </p>
 */
public interface PaperService extends IService<Paper> {

    /**
     * 创建试卷
     *
     * @param userId
     * @param examId
     * @return
     */
    String createPaper(String userId, String examId);


    /**
     * 查找详情
     *
     * @param paperId
     * @return
     */
    ExamDetailRespDTO paperDetail(String paperId);

    /**
     * 考试结果
     *
     * @param paperId
     * @return
     */
    ExamResultRespDTO paperResult(String paperId);

    /**
     * 查找题目详情
     *
     * @param paperId
     * @param quId
     * @return
     */
    PaperQuDetailDTO findQuDetail(String paperId, String quId);

    /**
     * 填充答案
     *
     * @param reqDTO
     */
    void fillAnswer(PaperAnswerDTO reqDTO);

    /**
     * 交卷操作
     *
     * @param paperId
     * @return
     */
    void handExam(String paperId);

    /**
     * 阅卷完成
     *
     * @param reqDTO
     */
    void reviewPaper(ExamResultRespDTO reqDTO);


    /**
     * 试卷列表响应类
     *
     * @param reqDTO
     * @return
     */
    IPage<PaperListRespDTO> paging(PagingReqDTO<PaperListReqDTO> reqDTO);

    /**
     * 判断某考生是否考过该考试
     *
     * @param userId
     * @param examId
     * @return
     */
    boolean isExist(String userId, String examId);

    /**
     * 查找某场考试的所有试卷
     *
     * @param examId
     * @return
     */
    List<Paper> listByExamId(String examId);

    /**
     * 计算某场考试的所有试卷数量
     *
     * @param examId
     * @return
     */
    Integer calcPaperNum(String examId);

    /**
     * 计算某场考试的所有待阅卷试卷数量
     *
     * @param examId
     * @return
     */
    Integer calcReviewPaperNum(String examId);

    /**
     * 计算某场考试的所有已阅卷试卷数量
     *
     * @param examId
     * @return
     */
    Integer calcNoReviewPaperNum(String examId);

    /**
     * 查询导出的试卷列表
     *
     * @param reqDTO
     * @return
     */
    List<PaperExportDTO> listForExport(PaperListReqDTO reqDTO);

    /**
     * 查找到期未交卷的考试
     *
     * @return
     */
    List<Paper> findDeadPapers();

    /**
     * 取消考试
     *
     * @param paperId
     */
    void breakExam(String paperId);


}
